home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / background.z / background
Encoding:
Text File  |  2002-10-03  |  13.2 KB  |  265 lines
  1.  
  2.  
  3.  
  4. BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))                                                    BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      background - customization panel for setting background pattern
  10.  
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ////uuuussssrrrr////ssssbbbbiiiinnnn////bbbbaaaacccckkkkggggrrrroooouuuunnnndddd
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _b_a_c_k_g_r_o_u_n_d customization panel is used to edit the background for a
  18.      particular desk.  The user is presented with a list of different
  19.      backgrounds.  All backgrounds except those using the graphics library
  20.      (GL) can be previewed.  The user can select a background, modify its
  21.      colors if it is a non-GL pattern, then apply the background pattern to
  22.      the current desk.
  23.  
  24.  
  25.      The _b_a_c_k_g_r_o_u_n_d panel can be run from a Unix shell command line or from
  26.      the toolchest (Desktop > Customize > Background).  Like most other
  27.      customization panels, the background panel has the ``runonce'' feature,
  28.      meaning only one instance of the application will at one time.
  29.      Attempting to launch the application a second time will have the effect
  30.      of deiconifying the application window or popping it to the top on the
  31.      current desk.
  32.  
  33.  
  34.      For more information about the entire IRIX Interactive Desktop
  35.      environment and about the XXXXUUUUSSSSEEEERRRRFFFFIIIILLLLEEEESSSSEEEEAAAARRRRCCCCHHHHPPPPAAAATTTTHHHH environment variable, see
  36.      the IID(1) man page.
  37.  
  38.  
  39. FFFFIIIILLLLEEEESSSS
  40.      The background patterns presented in this panel are derived from one of
  41.      two files:
  42.  
  43.      /usr/lib/X11/system.backgrounds (system default)
  44.      $HOME/.backgrounds              (user)
  45.  
  46.  
  47.      Either the user's backgrounds or the system default backgrounds will be
  48.      presented in the background panel.  If a $_H_O_M_E/._b_a_c_k_g_r_o_u_n_d_s file exists,
  49.      then the backgrounds on that list will be presented in the panel.
  50.      Otherwise the backgrounds in the system default file will be presented.
  51.      If the user desires to append some backgrounds to the system default
  52.      list, the user must first copy the system default file to the
  53.      $_H_O_M_E/._b_a_c_k_g_r_o_u_n_d_s file in their home directory, then use a text editor
  54.      to append new background entries to that file.
  55.  
  56.  
  57.      Each background entry has the following format:
  58.  
  59.          bbbbaaaacccckkkkggggrrrroooouuuunnnndddd     <<<<nnnnaaaammmmeeee>>>>
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))                                                    BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))
  71.  
  72.  
  73.  
  74.          ccccoooommmmmmmmaaaannnndddd        <<<<4444DDDDwwwwmmmm ccccoooommmmmmmmaaaannnndddd>>>>
  75.          ddddeeeeffffaaaauuuulllltttt        <<<<ddddeeeeffffaaaauuuulllltttt ccccoooommmmmmmmaaaannnndddd>>>>
  76.          rrrreeeeaaaaddddooookkkk         <<<<ffffiiiilllleeee1111>>>>,,,, <<<<ffffiiiilllleeee2222>>>>,,,, ............
  77.  
  78.  
  79.      The bbbbaaaacccckkkkggggrrrroooouuuunnnndddd line defines the name of the background that the user will
  80.      see from the customization panel.
  81.  
  82.  
  83.      The ccccoooommmmmmmmaaaannnndddd line specifies the command that will be passed to _4_D_w_m, which
  84.      handles the management of backgrounds.  This command can have formatting
  85.      characters (%1 %2 %3 ...) representing how many colors the background
  86.      requires as well as how many the user may edit, up to a maximum of five
  87.      colors.
  88.  
  89.      Currently all command formats acceptable to the _x_s_e_t_r_o_o_t(_1) command may
  90.      be used, as well as a ----xxxxppppmmmm option for files in X pixmap (xpm) format.
  91.  
  92.      Additionally a ----eeeexxxxeeeeccccuuuutttteeee option allows execution of any background setting
  93.      command (for example, _t_w_i_l_i_g_h_t(_6_D)).  However, use of arbitrary
  94.      backgrounds set via the ----eeeexxxxeeeeccccuuuutttteeee command may degrade performance,
  95.      especially if file manager icons are on the background.  Also note that
  96.      to integrate with the IRIX Interactive Desktop environment, any X program
  97.      introduced as a new background (for example, _x_e_a_r_t_h) needs to set the
  98.      _SGI_ROOTPAINTER_ID property on its window and on the root window.  (This
  99.      property needs to be of type WINDOW and have a value of the window on
  100.      which the property is set.)  If the background-setting program does not
  101.      set this property, then the window manager, _4_D_w_m(_1_X), will not know on
  102.      which window to perform an XKillClient operation when the user switches
  103.      desks or selects a new background.  Without the property set, the
  104.      background-setting program can run multiple times, which can load the
  105.      system unnecessarily.  In short, users can have any X program running as
  106.      their background, but if that program does not set the
  107.      _SGI_ROOTPAINTER_ID property, then they need to kill that program
  108.      manually every time they switch desks or switch backgrounds.
  109.  
  110.      The ddddeeeeffffaaaauuuulllltttt line designates the image the user will originally see in the
  111.      viewer as well as its default colors.
  112.  
  113.  
  114.      The rrrreeeeaaaaddddooookkkk command checks that the files listed can actually be read.  If
  115.      they can not, the background will not be presented to the user in the
  116.      _b_a_c_k_g_r_o_u_n_d panel.
  117.  
  118.  
  119.      For example, the following is the entry for the two-color Scatter
  120.      background pattern:
  121.  
  122.      bbbbaaaacccckkkkggggrrrroooouuuunnnndddd """"SSSSccccaaaatttttttteeeerrrr""""
  123.         ccccoooommmmmmmmaaaannnndddd """"----bbbbiiiittttmmmmaaaapppp ////uuuussssrrrr////iiiinnnncccclllluuuuddddeeee////XXXX11111111////bbbbiiiittttmmmmaaaappppssss////ggggrrrraaaannnniiiitttteeee ----bbbbgggg %%%%1111 ----ffffgggg %%%%2222""""
  124.         ddddeeeeffffaaaauuuulllltttt """"----bbbbiiiittttmmmmaaaapppp ////uuuussssrrrr////iiiinnnncccclllluuuuddddeeee////XXXX11111111////bbbbiiiittttmmmmaaaappppssss////ggggrrrraaaannnniiiitttteeee ----bbbbgggg lllliiiigggghhhhttttsssstttteeeeeeeellllbbbblllluuuueeee3333 ----ffffgggg hhhhoooonnnneeeeyyyyddddeeeewwww1111""""
  125.         rrrreeeeaaaaddddooookkkk """"////uuuussssrrrr////iiiinnnncccclllluuuuddddeeee////XXXX11111111////bbbbiiiittttmmmmaaaappppssss////ggggrrrraaaannnniiiitttteeee""""
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))                                                    BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))
  137.  
  138.  
  139.  
  140. NNNNOOOOTTTTEEEESSSS
  141.      4Dwm caches backgrounds for all desks.  If a user has many desks, each
  142.      using many colors, the colors can fill up the colormap.  Similarly, if
  143.      many desks each have large background pixmaps, much server memory can be
  144.      used.
  145.  
  146.      IRIX 6.5.14 introduced some new non-GL background patterns: Citrus
  147.      Citrus, Camouflage, Sand, Sky (HDTV), Sprinkle, Reef, Reef (HDTV),
  148.      Midnight, and Iron.  Except for Sprinkle, these new patterns are
  149.      unusually large pixmaps; their sizes are 1280x1024 pixels except the
  150.      "HDTV" backgrounds which are intended for 1920x1200-pixel screens.  The
  151.      large backgrounds can be used on monitors at any resolution, but they
  152.      look best when the screen matches their size.  (Users can customize the
  153.      colors of any non-GL background by clicking the color squares in the
  154.      Background panel.)
  155.  
  156.      Using the new 1280x1024 and 1920x1200 backgrounds will cause _X_s_g_i, the
  157.      _b_a_c_k_g_r_o_u_n_d panel and _4_D_w_m to consume several megabytes more memory than
  158.      usual, hence it is recommended that these large desktop patterns be
  159.      applied prudently.  It will take longer for the _b_a_c_k_g_r_o_u_n_d panel to
  160.      display the previews for these large patterns than for the small ones,
  161.      and login may take several more seconds, but desk switching should not
  162.      suffer performance degradation.  The user can free the consumed memory by
  163.      clicking the _b_a_c_k_g_r_o_u_n_d panel's Close button, by applying a smaller
  164.      pattern then restarting 4Dwm (System > Utilities > Restart Window Manager
  165.      on the toolchest), and/or by logging out.  To avoid consuming much memory
  166.      on low-memory IRIX workstations, do not apply any of the new large
  167.      pixmaps to any desk's background and remember to close the _b_a_c_k_g_r_o_u_n_d
  168.      panel when done previewing patterns.
  169.  
  170.      Setting a background via the ----eeeexxxxeeeeccccuuuutttteeee flag in the background panel
  171.      differs from setting the same background from the command line in that
  172.      those backgrounds set via the background panel will be remembered across
  173.      desk switches and restarted automatically when returning to the desk.
  174.      Backgrounds started from the command line will be forgotten after a desk
  175.      switch.  (However, backgrounds set using the _x_s_e_t_r_o_o_t(_1) command or
  176.      _b_g_p_a_s_t_e(_6_D) will be remembered across desk switches.)
  177.  
  178.  
  179.      Here is an example $$$$HHHHOOOOMMMMEEEE////....bbbbaaaacccckkkkggggrrrroooouuuunnnnddddssss entry for an RGB background:
  180.  
  181.      bbbbaaaacccckkkkggggrrrroooouuuunnnndddd """"GGGGeeeennnneeeessssiiiissss""""
  182.         ccccoooommmmmmmmaaaannnndddd """"----eeeexxxxeeeeccccuuuutttteeee ////uuuussssrrrr////ssssbbbbiiiinnnn////bbbbggggppppaaaasssstttteeee ----oooo 0000 0000 ----tttt 0000 0000 0000 ////uuuussssrrrr////ttttmmmmpppp////ggggeeeennnneeeessssiiiissss....rrrrggggbbbb""""
  183.         ddddeeeeffffaaaauuuulllltttt """"----eeeexxxxeeeeccccuuuutttteeee ////uuuussssrrrr////ssssbbbbiiiinnnn////bbbbggggppppaaaasssstttteeee ----oooo 0000 0000 ----tttt 0000 0000 0000 ////uuuussssrrrr////ttttmmmmpppp////ggggeeeennnneeeessssiiiissss....rrrrggggbbbb""""
  184.         eeeexxxxeeeeooookkkk """"////uuuussssrrrr////ssssbbbbiiiinnnn////bbbbggggppppaaaasssstttteeee""""
  185.         rrrreeeeaaaaddddooookkkk """"////uuuussssrrrr////ttttmmmmpppp////ggggeeeennnneeeessssiiiissss....rrrrggggbbbb""""
  186.  
  187.  
  188.  
  189.      4Dwm records the user's chosen backgrounds (including any color
  190.      customizations) for every desk in the user's $$$$HHHHOOOOMMMMEEEE////....SSSSggggiiiirrrreeeessssoooouuuurrrrcccceeeessss ffffiiiilllleeee....
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))                                                    BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD((((1111))))
  203.  
  204.  
  205.  
  206. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  207.      4Dwm(1X), xsetroot(1), ov(1), IID(1)
  208.  
  209.  
  210. BBBBUUUUGGGGSSSS
  211.      The maximum number of editable colors in the customization panel is five.
  212.      If a pixmap contains more than that many, only the first five will be
  213.      available in the palette beneath the image viewing area.
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.